Continuously plays a theme-specific sound associated with the user’s movement of a given interface object.

OSStatus BeginThemeDragSound (
    ThemeDragSoundKind kind
);

kind

A value of type ThemeDragSoundKind. Pass a constant specifying the sound to play; see “Theme Drag Sound Constants” for descriptions of possible values.

function result

A result code.

DISCUSSION

The Appearance Manager automatically plays drag sounds for standard user interface elements and for Drag Manager drag actions. Your application may call BeginThemeDragSound, typically upon detecting a drag initiation, to play a drag sound for a custom element. BeginThemeDragSound plays the specified sound in a continuous loop until your application calls the function EndThemeDragSound, typically upon receiving a mouse-up event.

Note that the BeginThemeDragSound function automatically tracks the current mouse position and handles any panning or variations in pitch for the sound.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)